KCChooseCertificate

KCChooseCertificate
Header:	Keychain.h		Carbon status:	Under Evaluation

Displays a list of certificates that the user can choose from.

OSStatus KCChooseCertificate (
    CFArrayRef items, 
    KCItemRef *certificate, 
    CFArrayRef policyOIDs, 
    KCVerifyStopOn stopOn
);

Parameter descriptions

items: An array of certificate references.
certificate: If the items array only contains one certificate, on return, a pointer to that certificate. In this case, no user interface is displayed.
policyOIDs: An array of trust policy options used for Macintosh file signing. To obtain a pointer to this array, call the function SecMacGetDefaultPolicyOIDs.
stopOn: The criteria to use in selecting the certificates to display. See “Certificate Verification Criteria Constants” for a description of this mask.

function result: A result code. The result code userCanceledErr indicates that the user pressed the Cancel button in the user interface.

DISCUSSION

The KCChooseCertificate function displays a list of the certificates the user can choose from. If only one certificate matches the criteria, the reference is passed back in the certificate parameter and no user interface is presented.

VERSION NOTES

Available beginning with Keychain 2.0.